Army  Research  Laboratory 


ScreenRecorder:  A  Utility  for  Creating  Screenshot  Video 
Using  Only  Original  Equipment  Manufacturer  (OEM) 
Software  on  Microsoft  Windows  Systems 


by  Mary  K  Arthur 


ARL-TN-0658 


January  2015 


Approved  for  public  release;  distribution  is  unlimited. 


NOTICES 

Disclaimers 

The  findings  in  this  report  are  not  to  he  construed  as  an  official  Department  of  the  Army  position  unless 
so  designated  hy  other  authorized  documents. 

Citation  of  manufacturer’s  or  trade  names  does  not  constitute  an  official  endorsement  or  approval  of  the 
use  thereof. 


Destroy  this  report  when  it  is  no  longer  needed.  Do  not  return  it  to  the  originator. 


Army  Research  Laboratory 

Aberdeen  Proving  Ground,  MD  21005-5069 


ARL-TN-0658 


January  2015 


ScreenRecorder:  A  Utility  for  Creating  Screenshot  Video 
Using  Only  Original  Equipment  Manufacturer  (OEM) 
Software  on  Microsoft  Windows  Systems 

Mary  K  Arthur 

Weapons  and  Materials  Research  Directorate,  ARL 


Approved  for  public  release;  distribution  is  unlimited. 


REPORT  DOCUMENTATION  PAGE 


Form  Approved 
0MB  No.  0704-0188 


Public  reporting  burden  for  this  collection  of  information  is  estimated  to  average  1  hour  per  response,  including  the  time  for  reviewing  instructions,  searching  existing  data  sources,  gathering 
and  maintaining  the  data  needed,  and  completing  and  reviewing  the  collection  information.  Send  comments  regarding  this  burden  estimate  or  any  other  aspect  of  this  collection  of  information, 
including  suggestions  for  reducing  the  burden,  to  Department  of  Defense,  Washington  Headquarters  Services,  Directorate  for  Information  Operations  and  Reports  (0704-0188),  1215  Jefferson 
Davis  Highway,  Suite  1204,  Arlington,  VA  22202-4302.  Respondents  should  be  aware  that  notwithstanding  any  other  provision  of  law,  no  person  shall  be  subject  to  any  penalty  for  failing  to 
comply  with  a  collection  of  information  if  it  does  not  display  a  currently  valid  OMB  control  number. 

PLEASE  DO  NOT  RETURN  YOUR  FORM  TO  THE  ABOVE  ADDRESS. 


12.  DISTRIBUTION/AVAILABILITY  STATEMENT 

Approved  for  public  release;  distribution  is  unlimited. 

13.  SUPPLEMENTARY  NOTES 


14.  ABSTRACT 

Being  able  to  save  screenshots  directly  to  a  file  and  to  record  activity  on  a  desktop  or  within  a  specific  window  is  extremely 
useful  for  a  variety  of  reasons.  Although  third-party  screen-recording  software  is  readily  available  online  from  a  variety  of 
sources,  such  software  often  presents  a  security  concern  and  would  require  administrative  permissions  to  install.  This  report 
presents  a  software  utility  for  capturing  series  of  desktop  or  window  screenshots  using  only  original  equipment  manufacturer 
software  on  systems  running  Microsoft  Windows. 


15.  SUBJECT  TERMS 

screenshot,  screen  capture,  screen  record,  desktop,  window,  handle,  Microsoft,  Windows,  original  equipment  manufacturer, 
OEM,  Visual  Studio,  Movie  Maker,  C-H-,  object-oriented 

17.  LIMITATION  18.  NUMBER 
OF  ABSTRACT  OF  PAGES 

UU _ 46 

Standard  Form  298  (Rev.  8/98) 

Prescribed  by  ANSI  Std.  Z39.18 


19a.  NAME  OF  RESPONSIBLE  PERSON 

Mary  K  Arthur 

19b.  TELEPHONE  NUMBER  {Include  area  code) 

410-278-6110 


16.  SECURITY  CLASSIFICATION  OF: 


a.  REPORT 

b.  ABSTRACT 

C.  THIS  PAGE 

Unclassified 

Unclassified 

Unclassified 

1.  REPORT  DATE  (DD-MM-YYYY) 

2.  REPORT  TYPE 

January  2015 

Einal 

4.  TITLE  AND  SUBTITLE 

ScreenRecorder:  A  Utility  for  Creating  Screenshot  Video  Using  Only  Original 
Equipment  Manufacturer  (OEM)  Software  on  Microsoft  Windows  Systems 


6.  AUTHOR(S) 

Mary  K  Arthur 


7.  PERFORMING  ORGANIZATION  NAME(S)  AND  ADDRESS(ES) 

US  Army  Research  Laboratory 

ATTN:  RDRL-WML-A 

Aberdeen  Proving  Ground,  MD  21005-5069 

9.  SPONSORING/MONITORING  AGENCY  NAME(S)  AND  ADDRESS(ES) 


3.  DATES  COVERED  (From  -  To) 

August  2014 

5a.  CONTRACT  NUMBER 

5b.  GRANT  NUMBER 


5c.  PROGRAM  ELEMENT  NUMBER 


5d.  PROJECT  NUMBER 

AH80 

5e.  TASK  NUMBER 


5f.  WORK  UNIT  NUMBER 


8.  PERFORMING  ORGANIZATION 
REPORT  NUMBER 

ARL-TN-0658 


10.  SPONSOR/MONITOR’S  ACRONYM(S) 


11.  SPONSOR/MONITOR'S  REPORT 
NUMBER(S) 


11 


Contents 


List  of  Figures  iv 

Acknowledgments  v 

1.  Introduction  1 

2.  ScreenRecorder:  Static  Member  Functions,  Screen  Capture  2 

2. 1  CaptureDesktop . 2 

2.2  CaptureByTitle . 3 

2.3  CaptureByHandle . 5 

3.  ScreenRecorder:  Class  Variables,  Constructors,  Accessors,  and  Mutators  6 

3.1  Constructors . 6 

3.2  Accessors . 7 

3.3  Mutators . 7 

4.  ScreenRecorder:  Non-Static  Member  Functions,  Screen  Record  8 

4. 1  RecordDesktop . 8 

4.2  RecordByTitle . 9 

4.3  RecordByHandle . 11 

5.  Conclusion  12 

6.  References  and  Notes  13 

Appendix  A.  ScreenRecorderExamples_Capture.cc  15 

Appendix  B.  ScreenRecorderExamples_Record.cc  19 

Appendix  C.  ScreenRecorder.h  23 

Appendix  D.  ScreenRecorder.ee  27 

Appendix  E.  MATLAB  Script  for  Creating  AVI  Movie  from  Screenshots  35 

ill 


Distribution  List 


37 


List  of  Figures 


Fig.  1  Static  member  function  (screen  capture)  declarations  in  ScreenRecorder.h.  See 
Appendix  C  for  full  documentation  of  ScreenRecorder.h  and  Appendix  D  for  full  class 
implementation  in  ScreenRecorder.ee . 2 

Fig.  2  Sample  usage  of  CaptureDesktop  functions  from 

ScreenRecorderExamples_Capture.ee.  See  Appendix  A  for  full  documentation  of 
ScreenRecorderExamples_Capture.ee . 3 

Eig.  3  Sample  usage  of  CaptureBy Title  functions  from 

ScreenRecorderExamples_Capture.ee.  See  Appendix  A  for  full  documentation  of 
ScreenRecorderExamples_Capture.ee . 4 

Eig.  4  Sample  usage  of  CaptureByHandle  functions  from 

ScreenRecorderExamples_Capture.ee.  See  Appendix  A  for  full  documentation  of 
ScreenRecorderExamples_Capture.ee . 5 

Eig.  5  Constructor  declarations  in  ScreenRecorder.h.  See  Appendix  C  for  full 

documentation  of  ScreenRecorder.h,  and  appendix  D  for  full  class  implementation  in 
ScreenRecorder.ee . 6 

Eig.  6  Accessor  declarations  in  ScreenRecorder.h.  See  Appendix  C  for  full  documentation 

of  ScreenRecorder.h  and  appendix  D  for  full  class  implementation  in  ScreenRecorder.ee . 7 

Eig.  7  Mutator  declarations  in  ScreenRecorder.h.  See  Appendix  C  for  full  documentation  of 
ScreenRecorder.h  and  appendix  D  for  full  class  implementation  in  ScreenRecorder.ee . 7 

Eig.  8  Non-static  member  function  (screen  record)  declarations  in  ScreenRecorder.h.  See 
Appendix  C  for  full  documentation  of  ScreenRecorder.h  and  appendix  D  for  full  class 
implementation  in  ScreenRecorder.ee . 8 

Eig.  9  Sample  usage  of  RecordDesktop  functions  from 

ScreenRecorderExamples_Record.ee.  See  Appendix  B  for  full  documentation  of 
ScreenRecorderExamples_Record.ee . 9 

Eig.  10  Sample  usage  of  RecordByTitle  functions  from 

ScreenRecorderExamples_Record.ee.  See  Appendix  B  for  full  documentation  of 
ScreenRecorderExamples_Record.ee . 10 

Eig.  1 1  Sample  usage  of  RecordByHandle  functions  from 

ScreenRecorderExamples_Record.ee.  See  Appendix  B  for  full  documentation  of 
ScreenRecorderExamples_Record.ee . 11 


IV 


Acknowledgments 


I  would  like  to  thank  Ben  Breech  for  his  extremely  thorough  technical  review,  feedback,  and 
suggestions  that  greatly  improved  the  quality  of  the  ScreenRecorder  utility  and  this  report.  I 
would  also  like  to  thank  Mark  Gatlin  for  his  editorial  review. 


V 


Intentionally  left  blank. 


VI 


1.  Introduction 


Being  able  to  save  screenshots  directly  to  a  file  and  to  record  activity  on  a  desktop  or  within  a 
specific  window  is  extremely  useful  for  a  variety  of  reasons  including,  but  not  limited  to, 
diagnosing  computer  problems,  teaching  and/or  demonstrating  software,  and  generating  videos 
for  presentations.  Although  third-party  screen-recording  software  is  readily  available  online  from 
a  variety  of  sources,  such  software  often  presents  a  security  concern  and  would  require 
administrative  permissions  to  install.  This  report  presents  ScreenRecorder,  a  software  utility  for 
capturing  series  of  desktop  or  window  screenshots  using  only  original  equipment  manufacturer 
(OEM)  software  on  systems  running  Microsoft  Windows.^ 

The  ScreenRecorder  utility  was  developed  as  an  objected-oriented  C-i-i-  class  within  Microsoft 
Visual  Studio.  It  has  been  tested  on  and  is  compatible  with  Microsoft  Vista,  7,  and  8  and  Visual 
Studio  Express  2008,  2010,  and  2012.  The  utility  supports  5  image  formats:  Windows  Bitmap 
(BMP),  Graphics  Interchange  Eormat  (GIE),  Joint  Photographic  Experts  Group  (JPEG),  Portable 
Network  Graphics  (PNG),  and  Tagged  Image  Pile  Eormat  (TIPP).  Once  the  ScreenRecorder 

'3 

Utility  has  saved  a  series  of  screenshots  in  the  desired  format,  Windows  Movie  Maker  can  be 
used  to  combine  the  screenshot  images  into  a  Windows  media  file  (WMV)  or  Audio-Video 
Interleaved  (AVI)  movie  file.  This  report  does  not  explicitly  address  creating  a  video  from  a 
series  of  images  but  rather  directs  the  user  to  Microsoft’s  Windows  Movie  Maker  tutorial"^  for 
further  information  regarding  creating  videos  from  images  using  Microsoft  OEM  software.^ 

Punctions  within  the  ScreenRecorder  utility  fall  into  3  categories:  1)  static  screen  capture 
member  functions  for  saving  a  single  screenshot  to  a  file  that  can  be  invoked  without  using  a 
ScreenRecorder  object,  2)  functions  for  creating  and  manipulating  ScreenRecorder  objects 
(constructors,  accessors,  and  mutators),  and  3)  non-static  screen  recording  member  functions  for 
saving  a  series  of  screenshots  to  file  that  can  only  be  accessed  through  a  ScreenRecorder  object. 

The  use  of  the  ScreenRecorder  utility  assumes  a  basic  understanding  of  compiling  and  running 
C-i-i-  code  within  Microsoft  Visual  Studio.  This  report  does  not  attempt  to  explain  the  inner 
workings  of  the  ScreenRecorder  utility  but  is  published  as  a  means  to  distribute  the  source  code 
and  act  as  a  user's  manual.  All  source  code  is  provided  to  the  user  within  the  appendices.  The 
source  code  is  completely  self-contained,  and  the  user  need  only  include  the  files  in  a  Visual 
Studio  project  and  link  to  the  following  3  standard  Windows  libraries:  user32,  gdi32,  and 
gdiplus.  See  example  codes  in  Appendices  A  and  B  for  an  example  of  how  to  link  these  libraries. 
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2.  ScreenRecorder:  Static  Member  Functions,  Screen  Capture 


The  ScreenRecorder  utility  includes  4  static  member  functions  for  capturing  a  single  screenshot 
image:  CaptureDesktop,  CaptureByTitle,  and  2  versions  of  CaptureByHandle  (Fig.  1). 


21 

22 

23 

II  **** 

Static  Methods  -  Screen  Capture 

++****++***+*++**+**+*****++****++**+**+***+* 

static 

bool  CaptureDesktop(std :: string 

saveAsFile 

=  "ScreenCapture.png", 

24 

std : : string 

saveAsPath 

25 

static 

bool 

CaptureByTitle(std: :string 

title. 

26 

std : : string 

saveAsFile 

=  "ScreenCapture.png", 

27 

std : : string 

saveAsPath 

28 

static 

bool 

CaptureByHandle(std : : string 

handle. 

29 

std : : string 

saveAsFile 

=  "ScreenCapture.png", 

30 

std : : string 

saveAsPath 

31 

static 

bool 

CaptureByHandle(HWND 

hWnd, 

32 

std : : string 

saveAsFile 

=  "ScreenCapture.png", 

33 

std : : string 

saveAsPath 

Fig.  1  Static  member  function  (screen  capture)  declarations  in  ScreenRecorder.h.  See  Appendix  C  for  full 

documentation  of  ScreenRecorder.h  and  Appendix  D  for  full  class  implementation  in  ScreenRecorder.ee. 


2.1  CaptureDesktop 

The  CaptureDesktop  function  saves  a  single  image  of  the  desktop.  CaptureDesktop  takes  up  to  2 
string^  parameters. 

If  no  parameters  are  supplied,  the  image  of  the  desktop  is  saved  as  ScreenCapture.png  in  the 
same  directory  as  the  executable  (Fig.  2,  lines  31  and  32). 

If  a  single  string  parameter  is  supplied,  this  parameter  specifies  the  save-as  filename.  The  image 
of  the  desktop  is  then  saved  with  the  specified  filename  in  the  same  directory  as  the  executable 
(Fig.  2,  lines  37  and  38). 

If  2  string  parameters  are  supplied,  the  first  parameter  specifies  the  save-as  filename  and  the 
second  is  the  path  to  the  desired  save  location.  The  image  of  the  desktop  is  then  saved  with  the 
specified  filename  in  the  specified  directory  (Fig.  2,  lines  43-46). 
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ScreenRecorder  recorder;  //  ScreenRecorder  object 

//  ****  ScreenRecorder :: CaptureDesktop  *++**+*+****+*****+**+**+**++*+**++**+**+**++* 
//  CaptureDesktop 

if  ( IScreenRecorder: :CaptureDesktop()  ||  //  Invoked  without  use  of  a  class  object 

! recorder .CaptureDesktop( ) )  {  //  Invoked  through  a  class  object 

std::cerr  <<  "ScreenRecorder: :CaptureDesktop  failed"  <<  std::endl; 

}  //  if  ( ! CaptureDesktop( ) ) 

//  CaptureDesktop(saveAsFile) 

if  ( IScreenRecorder: :CaptureDesktop("CaptureDesktop. bmp")  || 

! recorder .CaptureDesktop( "CaptureDesktop.bmp"))  { 
std::cerr  <<  "ScreenRecorder: :CaptureDesktop  failed"  <<  std::endl; 

}  //  if  ( ! CaptureDesktop( . . . ) ) 

//  CaptureDesktop(saveAsFilej  saveAsPath) 

if  ( IScreenRecorder: :CaptureDesktop("CaptureDesktop.gif"j 

"C:\\Documents\\ScreenRecorder")  | | 

! recorder .CaptureDesktop( "CaptureDesktop. gif "j 

"C : \\Documents\\ScreenRecorder" ) )  { 
std::cerr  <<  "ScreenRecorder: :CaptureDesktop  failed"  <<  std::endl; 

}  //  if  ( ! CaptureDesktop( . . . ) ) 


Fig.  2  Sample  usage  of  CaptureDesktop  functions  from  ScreenRecorderExamples_Capture.cc.  See  Appendix  A  for 
full  documentation  of  ScreenRecorderExamples_Capture.cc. 

The  return  value  of  CaptureDesktop  indicates  whether  or  not  an  image  of  the  desktop  was 
successfully  saved.  If  the  user  specifies  the  filename,  the  CaptureDesktop  function  will  return 
false  if  the  specified  filename  does  not  end  with  one  of  the  supported  file  format  extensions  (i.e., 
bmp,  gif,  jpg/jpeg,  png,  or  tif/tiff).  If  the  user  specifies  a  save  path  that  does  not  exist, 
CaptureDesktop  will  return  false. 

Windows  is  generally  case-insensitive;  all  functions  in  the  ScreenRecorder  utility  are  case- 
insensitive. 

2.2  CaptureByTitle 

The  CaptureByTitle  function  saves  a  single  image  of  the  window  identified  by  the  specified  title. 
CaptureByTitle  requires  at  least  one  string  parameter  (the  title  of  the  window  to  capture) 
followed  by  up  to  2  string  parameters. 

If  only  the  required  title  string  parameter  is  supplied,  the  image  of  the  specified  window  is  saved 
as  ScreenCapture.png  in  the  same  directory  as  the  executable  (Fig.  3,  lines  53  and  54). 
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ScreenRecorder  recorder;  //  ScreenRecorder  object 

50 

51 

52 

//  ****  ScreenRecorder : :CaptureByTitle  *++**+*+****+*+***+**+**+**++*+**++**+**+**++* 

//  CaptureByTitle(windowTitle) 

53 

if  ( IScreenRecorder: :CaptureByTitle("Microsoft  PowerPoint  -  [Sample. pptx] " )  || 

54 

! recorder .CaptureByTitle( "Microsoft  PowerPoint  -  [Sample. pptx] ") )  { 

55 

56 

57 

58 

std::cerr  <<  "ScreenRecorder: :CaptureByTitle  failed"  <<  std::endl; 

}  //  if  ( ! CaptureByTitle( . . . ) ) 

//  CaptureByTitle(windowTitlej  saveAsFile) 

59 

if  ( IScreenRecorder: :CaptureByTitle("Microsoft  PowerPoint  -  [Sample. pptx] ", 

60 

"CaptureByTitle. jpeg")  | | 

61 

! recorder .CaptureByTitle( "Microsoft  PowerPoint  -  [Sample. pptx] ", 

62 

"CaptureByTitle.jpg"))  { 

63 

64 

65 

66 

std::cerr  <<  "ScreenRecorder: :CaptureByTitle  failed"  <<  std::endl; 

}  //  if  ( ! CaptureByTitle( . . . ) ) 

//  CaptureByTitle(windowTitle,  saveAsFile,  saveAsPath) 

67 

if  ( IScreenRecorder: :CaptureByTitle("Microsoft  PowerPoint  -  [Sample. pptx] ", 

68 

"CaptureByTitle. png". 

69 

"C:\\Documents\\ScreenRecorder")  | | 

70 

! recorder .CaptureByTitle( "Microsoft  PowerPoint  -  [Sample. pptx] ", 

71 

"CaptureByTitle. png". 

72 

"C : \\Documents\\ScreenRecorder" ) )  { 

73 

std::cerr  <<  "ScreenRecorder: :CaptureByTitle  failed"  <<  std::endl; 

74 

}  //  if  ( ! CaptureByTitle( . . . ) ) 

Fig.  3  Sample  usage  of  CaptureByTitle  functions  from  ScreenRecorderExamples_Capture.cc.  See  Appendix  A  for 
full  documentation  of  ScreenRecorderExamples_Capture.cc. 

If  a  single  string  parameter  is  supplied  in  addition  to  the  required  title  string  parameter,  this 
parameter  specifies  the  save-as  filename.  The  image  of  the  specified  window  is  then  saved  with 
the  specified  filename  in  the  same  directory  as  the  executable  (Fig.  3,  lines  59-62). 

If  2  string  parameters  are  supplied  in  addition  to  the  required  title  string  parameter,  the  first 
parameter  specifies  the  save-as  filename  and  the  second  is  the  path  to  the  desired  save  location. 
The  image  of  the  specified  window  is  then  saved  with  the  specified  filename  in  the  specified 
directory  (Fig.  3,  lines  67-72). 

The  return  value  of  CaptureByTitle  indicates  whether  or  not  the  specified  window  was  found  and 
an  image  of  this  window  was  successfully  saved.  If  the  user  specifies  the  filename,  the 
CaptureByTitle  function  will  return  false  if  the  specified  filename  does  not  end  with  one  of  the 
supported  file  format  extensions.  If  the  user  specifies  a  save  path  that  does  not  exist, 
CaptureByTitle  will  return  false. 

The  “title”  that  appears  at  the  top  of  a  window  (in  the  title  bar)  is  not  necessarily  the  actual  title 
of  the  window.  The  easiest  way  to  determine  the  actual  title  of  the  window  is  to  open  Windows 
Task  Manager  (ctrl  -i-  shift  -i-  esc),  select  the  Applications  tab,  and  identify  the  task  that  you  are 
attempting  to  capture.  The  task  names  are  the  actual  window  titles. 
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2.3  CaptureByHandle 


Both  CaptureByHandle  functions  save  a  single  image  of  the  window  identified  by  the  specified 

•7 

window  handle.  Both  CaptureByHandle  functions  require  one  parameter  specifying  the  handle 
to  the  window  to  capture  followed  by  up  to  2  optional  string  parameters.  The  difference  between 
the  2  CaptureByHandle  functions  is  the  data  type  of  the  required  parameter  specifying  the  handle 
to  the  window  to  capture.  This  parameter  can  either  be  a  hex  string  identifier  to  the  handle  (e.g, 
“0012079E”)  or  a  Microsoft  Windows  window  handle  (HWND).* 

If  only  the  required  handle  identifier  parameter  is  supplied,  the  image  of  the  specified  window  is 
saved  as  ScreenCapture.png  in  the  same  directory  as  the  executable  (Fig.  4,  lines  85-88). 
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ScreenRecorder  recorderj  //  ScreenRecorder  object 
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//  ****  ScreenRecorder :: CaptureByHandle  ++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

//  Handle  object  to  window  titled  "Microsoft  PowerPoint  -  [Sample. pptx] " 

HWND  handleObject  =  FindWindow(NULLj  "Microsoft  PowerPoint  -  [Sample. pptx] ") j 

//  Hex  value  of  handleObject  saved  as  a  string 
std::string  handlestring  =  toString(handleObject) j 

//  CaptureByHandle(windowHandle) 

if  ( IScreenRecorder: :CaptureByHandle(handleObject)  || 

! recorder .CaptureByHandle(handleObject)  |  | 

IScreenRecorder: :CaptureByHandle(handleString)  | | 

! recorder. CaptureByHandle(handleString))  { 
std::cerr  <<  "ScreenRecorder: :CaptureByHandle  failed"  <<  std::endl; 

}  //  if  ( ! CaptureByHandle( . . . ) ) 

//  CaptureByHandle(windowHandlej  saveAsFile) 

if  ( IScreenRecorder: :CaptureByHandle(handleObjectj  "CaptureByHandle. tiff ")  || 

! recorder .CaptureByHandle(handleObjectj  "CaptureByHandle.tif")  | | 

IScreenRecorder: :CaptureByHandle(handleStringj  "CaptureByHandle.bmp")  | | 

! recorder .CaptureByHandle (handiest ring,  "CaptureByHandle.gif"))  { 
std::cerr  <<  "ScreenRecorder: :CaptureByHandle  failed"  <<  std::endlj 
}  //  if  ( ! CaptureByHandle( . . . ) ) 

//  CaptureByHandle(windowHandlej  saveAsFile,  saveAsPath) 

if  ( IScreenRecorder: :CaptureByHandle(handleObjectj  "CaptureByHandle. jpg", 

"C : \\Documents\\ScreenRecorder" )  | | 

! recorder . CaptureByHandle (handleObject J  "CaptureByHandle. png" , 

"C : \\Documents\\ScreenRecorder" )  | | 

! ScreenRecorder: : CaptureByHandle (handiest ring,  "CaptureByHandle.tif", 

"C : \\Documents\\ScreenRecorder" )  | | 

! recorder .CaptureByHandle(handleString,  "CaptureByHandle.bmp", 

"C : \\Documents\\ScreenRecorder" ) )  { 
std::cerr  <<  "ScreenRecorder: :CaptureByHandle  failed"  <<  std::endl; 

}  //  if  ( ! CaptureByHandle( . . . ) ) 


Fig.  4  Sample  usage  of  CaptureByHandle  functions  from  ScreenRecorderExamples_Capture.cc.  See  Appendix  A 
for  full  documentation  of  ScreenRecorderExamples_Capture.cc. 
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If  a  single  string  parameter  is  supplied  in  addition  to  the  required  handle  identifier  parameter,  this 
parameter  specifies  the  save-as  filename.  The  image  of  the  specified  window  is  then  saved  with 
the  specified  filename  in  the  same  directory  as  the  executable  (Fig.  4,  lines  93-96). 

If  2  string  parameters  are  supplied  in  addition  to  the  required  handle  identifier  parameter,  the  first 
parameter  specifies  the  save-as  filename  and  the  second  is  the  path  to  the  desired  save  location. 
The  image  of  the  specified  window  is  then  saved  with  the  specified  filename  in  the  specified 
directory  (Fig.  4,  lines  101-108). 

The  return  value  of  CaptureByHandle  indicates  whether  or  not  the  specified  window  was  found 
and  an  image  of  this  window  was  successfully  saved.  If  the  user  specifies  the  filename,  the 
CaptureByHandle  function  will  return  false  if  the  filename  does  not  end  with  one  of  the 
supported  file  format  extensions.  If  the  user  specifies  a  save  path  that  does  not  exist, 
CaptureByHandle  will  return  false. 


3.  ScreenRecorder:  Class  Variables,  Constructors,  Accessors,  and  Mutators 


A  ScreenRecorder  object  has  3  class  variables:  record  time,  frame  rate,  and  time  step.  The 
record-time  variable  is  the  duration  of  time  in  seconds  over  which  the  recorder  object  will 
capture  a  series  of  screenshots;  it  has  type  double  and  default  value  of  60.0  s.  The  frame-rate 
variable  is  the  number  of  screenshots  that  will  be  captured  each  second;  it  has  type  double  and 
default  value  of  1.0  frame  per  second  (fps).  The  time-step  variable  is  the  time  between 
screenshots  in  seconds;  it  has  type  double  and  default  value  of  1.0  s.  The  frame  rate  and  time  step 
are  inversely  proportional  and  related  by  the  following  equation: 


time  Step  = 


1 

frameRate' 


(1) 


The  ScreenRecorder  utility  includes  3  constructors,  3  accessor  functions,  and  3  mutator 
functions. 


3.1  Constructors 


The  default  constructor  for  a  ScreenRecorder  object  does  not  take  any  parameters  and  sets  the 
class  variables  to  their  default  values  (Fig.  5,  line  37). 


35 

36 

37 

38 

39 


//  ****  Constructors  +**++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+**+**++* 
ScreenRecorder( ) j 

ScreenRecorder(double  recordTime,  int  frameRate); 

ScreenRecorder(double  recordTime,  double  timeStep); 


Fig.  5  Constructor  declarations  in  ScreenRecorder.h.  See  Appendix  C  for  full  documentation  of  ScreenRecorder.h, 
and  appendix  D  for  full  class  implementation  in  ScreenRecorder.ee. 
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The  remaining  2  eonstruetors  both  require  2  parameters.  The  first  parameter  is  the  same  for  both 
construetors,  has  type  double,  and  specifies  the  record  time  in  seconds.  The  second  parameter 
either  has  type  integer  and  specifies  the  frame  rate^  in  frames  per  second  (figure  5,  line  38)  or  has 
type  double  and  specifies  the  time  step  in  seconds  (figure  5,  line  39).  If  a  record  time  of  less  than 
0.0  is  specified,  an  error  message  is  printed  to  the  standard  error  stream  (std::cerr)  and  the  record 
time  is  set  to  the  default  60.0  s.  If  a  frame  rate  of  0  or  less^*^  is  specified,  an  error  message  is 
printed  to  std::cerr  and  the  frame  rate  is  set  to  the  default  1.0  fps.  If  a  time  step  of  0.0  or  less  is 
specified,  an  error  message  is  printed  to  std::cerr  and  the  time  step  is  set  to  the  default  1.0  s. 

3.2  Accessors 

Accessor  functions,  often  called  “getters”,  are  methods  that  return  the  state  (value)  of  private 
member  variables.  The  ScreenRecorder  has  an  accessor  for  each  of  its  3  private  member 
variables:  GetRecordTime,  GetFrameRate,  and  GetTimeStep  (Fig.  6).  Accessors  do  not  take  any 
parameters.  GetRecordTime  returns  the  duration  of  time  in  seconds  over  which  the  recorder 
object  will  capture  a  series  of  screenshots.  GetFrameRate  returns  the  frame  rate  of  the  recorder 
object  in  frames  per  second.  GetTimeStep  returns  the  time  step  of  the  recorder  object  in  seconds. 


41 

II  **** 

Accessors  ++*+**++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+*****++* 

42 

43 

double 

GetRecordTime( ) j 

44 

double 

GetFrameRate( ) j 

45 

double 

GetTimeStepO; 

Fig.  6  Accessor  declarations  in  ScreenRecorder.h.  See  Appendix  C  for  full  documentation  of  ScreenRecorder.h  and 
appendix  D  for  full  class  implementation  in  ScreenRecorder.ee. 


3.3  Mutators 


Mutator  functions,  often  called  “setters”,  are  methods  for  changing  the  state  (value)  of  private 
member  variables.  The  ScreenRecorder  has  a  mutator  for  each  of  its  3  private  member  variables: 
SetRecordTime,  SetFrameRate,  and  SetTimeStep  (Fig.  7). 
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//  ****  Mutators  *++*+**++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

void  SetRecordTime(double  necordTime) ; 

void  SetFnameRate(double  frameRate); 

void  SetTimeStep(double  dT); 


Fig.  7  Mutator  declarations  in  ScreenRecorder.h.  See  Appendix  C  for  full  documentation  of  ScreenRecorder.h  and 
appendix  D  for  full  class  implementation  in  ScreenRecorder.ee. 

SetRecordTime  takes  one  parameter  of  type  double  and  with  units  in  seconds  and  sets  the 
duration  of  time  over  which  the  recorder  object  will  capture  a  series  of  screenshots  to  this  value. 
If  a  parameter  value  of  less  than  0.0  is  passed  to  SetRecordTime,  an  error  message  is  printed  to 
std::cerr  and  the  record  time  is  set  to  the  default  60.0  s. 

SetFrameRate  takes  one  parameter  of  type  double  and  with  units  in  frames  per  second  and  sets 
the  frame  rate  of  the  recorder  object  to  this  value.  If  a  parameter  value  that  is  less  than  or  equal 
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to  0.0  is  passed  to  SetFrameRate,  an  error  message  is  printed  to  std::cerr  and  the  frame  rate  is  set 
to  the  default  1.0  fps.  SetFrameRate  also  changes  the  object’s  time  step  to  be  equal  to  1.0  divided 
by  the  new  frame  rate. 

SetTimeStep  takes  one  parameter  of  type  double  and  with  units  in  seconds  and  sets  the  time  step 
of  the  recorder  object  to  this  value.  If  a  parameter  value  that  is  less  than  or  equal  to  0.0  is  passed 
to  SetTimeStep,  an  error  message  is  printed  to  std::cerr  and  the  time  step  is  set  to  the  default 
1.0  s.  SetTimeStep  also  changes  the  object’s  frame  rate  to  be  equal  to  1.0  divided  by  the  new 
time  step. 


4.  ScreenRecorder:  Non-Static  Member  Functions,  Screen  Record 


The  ScreenRecorder  utility  includes  4  non-static  member  functions  for  recording  a  series  of 
screenshot  images:  RecordDesktop,  RecordByTitle,  and  2  versions  of  RecordByHandle  (Fig.  8). 


53 

54 

55 

II  **** 

Non-Static  Methods  -  Screen  Record  *+*++**++*++*++**+**+**++*+**++**+**+**++* 

bool 

RecordDesktop(std : : string 

fileNameBase 

=  "ScreenRecorder. png". 

56 

std : : string 

saveAsPath 

= 

57 

bool 

RecordByTitle(std : : string 

title. 

58 

std : : string 

fileNameBase 

=  "ScreenRecorder. png". 

59 

std : : string 

saveAsPath 

= 

60 

bool 

RecordByHandle(std : : string 

handle. 

61 

std : : string 

fileNameBase 

=  "ScreenRecorder. png". 

62 

std : : string 

saveAsPath 

= 

63 

bool 

RecordByHandle(HWND 

hWnd, 

64 

std : : string 

fileNameBase 

=  "ScreenRecorder. png". 

65 

std : : string 

saveAsPath 

= 

Fig.  8  Non-static  member  function  (screen  record)  declarations  in  ScreenRecorder.h.  See  Appendix  C  for  full 
documentation  of  ScreenRecorder.h  and  appendix  D  for  full  class  implementation  in  ScreenRecorder.ee. 

4.1  RecordDesktop 

The  RecordDesktop  function  saves  a  series  of  images  of  the  desktop.  RecordDesktop  takes  up  to 
2  string  parameters. 

If  no  parameters  are  supplied,  a  ScreenRecorder  directory  is  created,  if  it  does  not  already  exist, 
in  the  same  directory  as  the  executable.  The  images  of  the  desktop  are  saved  as 
N_ScreenRecorder.png  in  this  directory  where  N  is  the  image  number  starting  from  0  (Fig.  9, 
line  68). 
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//  ****  ScreenRecorder : : RecordDesktop  +*++**+*+***++*++*++**+**+**++*+**++**+**+**++* 
//  RecordDesktop 

if  ( ! recorderl. RecordDesktop( ) )  { 

std::cerr  <<  "ScreenRecorder :: RecordDesktop  failed"  <<  '\n'j 
}  //  if  (! recorderl. RecordDesktop( ) ) 

//  RecordDesktop(saveAsFile) 

if  (! recorderZ. RecordDesktop( "RecordDesktop. bmp" ) )  { 

std::cerr  <<  "ScreenRecorder :: RecordDesktop  failed"  <<  '\n'j 
}  //  if  ( ! recorderZ. RecordDesktop( . . . ) ) 

//  RecordDesktop(saveAsFilej  saveAsPath) 

if  ( ! recorders. RecordDesktop( "RecordDesktop. gif "j 

"C : \\Documents\\ScreenRecorder" ) )  { 
std::cerr  <<  "ScreenRecorder :: RecordDesktop  failed"  <<  '\n'; 

}  //  if  (! recorders. RecordDesktop( ...) ) 


Fig.  9  Sample  usage  of  RecordDesktop  functions  from  ScreenRecorderExamples_Record.cc.  See  Appendix  B  for 
full  documentation  of  ScreenRecorderExamples_Record.cc. 

If  a  single  string  parameter  is  supplied,  this  parameter  specifies  the  base  of  the  save-as  filename. 
A  directory  with  the  same  name  as  the  filename  base  with  the  extension  removed  is  then  created, 
if  it  does  not  already  exist,  in  the  same  directory  as  the  executable.  The  images  of  the  desktop  are 
saved  as  N_filenameBase  in  this  directory.  Again,  N  is  the  image  number  starting  from  0  and 
filenameBase  is  the  user- specified  filename  base  (Fig.  9,  line  73). 

If  2  string  parameters  are  supplied,  the  first  parameter  specifies  the  base  of  the  save-as  filename 
and  the  second  is  the  path  to  the  desired  save  location.  A  directory  with  the  same  name  as  the 
filename  base  with  the  extension  removed  is  then  created,  if  it  does  not  already  exist,  in  the 
specified  directory.  The  images  of  the  desktop  are  saved  as  N_filenameBase  in  this  directory. 
Again,  N  is  the  image  number  starting  from  0  and  filenameBase  is  the  user-specified  filename 
base  (Fig.  9,  lines  78  and  79). 

The  return  value  of  RecordDesktop  indicates  whether  or  not  the  desired  series  of  images  of  the 
desktop  were  successfully  saved.  If  the  user  specifies  the  filename  base,  the  RecordDesktop 
function  will  return  false  if  the  filename  base  does  not  end  with  one  of  the  supported  file  format 
extensions.  If  the  user  specifies  a  save  path  that  does  not  exist,  RecordDesktop  will  return  false. 

4.2  RecordByTitle 

The  RecordByTitle  function  saves  a  series  of  images  of  the  window  identified  by  the  specified 
title.  RecordByTitle  requires  at  least  one  string  parameter  (the  title  of  the  window  to  capture) 
followed  by  up  to  3  string  parameters. 

If  only  the  required  title  string  parameter  is  supplied,  a  ScreenRecorder  directory  is  created,  if  it 
does  not  already  exist,  in  the  same  directory  as  the  executable.  The  images  of  the  specified 
window  are  then  saved  as  N_ScreenRecorder.png  in  this  directory  where  N  is  the  image  number 
starting  from  0  (Fig.  10,  line  86). 
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If  a  single  string  parameter  is  supplied  in  addition  to  the  required  title  string  parameter,  this 
parameter  specifies  the  base  of  the  save-as  filename.  A  directory  with  the  same  name  as  the 
filename  base  with  the  extension  removed  is  then  created,  if  it  does  not  already  exist,  in  the  same 
directory  as  the  executable.  The  images  of  the  specified  window  are  saved  as  N_filenameBase  in 
this  directory.  Again,  N  is  the  image  number  starting  from  0,  and  filenameBase  is  the  user- 
specified  filename  base  (Fig.  10,  lines  91-92). 


If  2  string  parameters  are  supplied  in  addition  to  the  required  title  string  parameter,  the  first 
parameter  specifies  the  base  of  the  save-as  filename  and  the  second  is  the  path  to  the  desired  save 
location.  A  directory  with  the  same  name  as  the  filename  base  with  the  extension  removed  is 
then  created,  if  it  does  not  already  exist,  in  the  specified  directory.  The  images  of  the  specified 
window  are  saved  as  N_filenameBase  in  this  directory.  Again,  N  is  the  image  number  starting 
from  0,  and  filenameBase  is  the  user-specified  filename  base  (Fig.  10,  lines  97-99). 
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//  ****  ScreenRecorder: :RecordByTitle  +*++****++**++*++*++**+*****++*+**++**+**+**+++ 
//  RecordByTitle(windowTitle) 

if  (! recorderl. RecordByTitle( "Microsoft  PowerPoint  -  [Sample. pptx] ") )  { 
std::cerr  <<  "ScreenRecorder :: RecordByTitle  failed"  <<  '\n'; 

}  //  if  (! recorderl. RecordByTitle( ...) ) 

//  RecordByTitle(windowTitlej  saveAsFile) 

if  (! recorderZ. RecordByTitle( "Microsoft  PowerPoint  -  [Sample. pptx] ", 

"RecordByTitle. jpeg"))  { 

std::cerr  <<  "ScreenRecorder :: RecordByTitle  failed"  <<  '\n'; 

}  //  if  ( ! recorderZ. RecordByTitle( . . . ) ) 

//  RecordByTitle(windowTitlej  saveAsFile,  saveAsPath) 

if  (! recorders. RecordByTitle( "Microsoft  PowerPoint  -  [Sample . pptx] ", 

"RecordByTitle. png", 

"C : \\Documents\\ScreenRecorder" ) )  { 
std::cerr  <<  "ScreenRecorder :: RecordByTitle  failed"  <<  '\n'j 
}  //  if  (! recorders. RecordByTitle( ...) ) 


Fig.  10  Sample  usage  of  RecordByTitle  functions  from  ScreenRecorderExamples_Record.cc.  See  Appendix  B  for 
full  documentation  of  ScreenRecorderExamples_Record.cc. 

The  return  value  of  RecordByTitle  indicates  whether  or  not  the  specified  window  was  found  and 
the  desired  series  of  images  of  this  window  were  successfully  saved.  If  the  user  specifies  the 
filename  base,  the  RecordByTitle  function  will  return  false  if  the  filename  base  does  not  end 
with  one  of  the  supported  file  format  extensions.  If  the  user  specifies  a  save  path  that  does  not 
exist,  RecordByTitle  will  return  false. 

As  in  CaptureByTitle,  the  “title”  that  appears  at  the  top  of  a  window  (in  the  title  bar)  is  not 
necessarily  the  actual  title  of  the  window.  The  easiest  way  to  determine  the  actual  title  of  the 
window  is  to  open  Windows  Task  Manager  (ctrl  -i-  shift  -i-  esc),  select  the  Applications  tab,  and 
identify  the  task  that  you  are  attempting  to  record.  The  task  names  are  the  actual  window  titles. 
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4.3  RecordByHandle 


Both  RecordByHandle  functions  save  a  series  of  images  of  the  window  identified  by  the 
specified  window  handle.  Both  RecordByHandle  functions  require  one  parameter  specifying  the 
handle  to  the  window  to  record  followed  by  up  to  2  optional  string  parameters.  The  difference 
between  the  2  RecordByHandle  functions  is  the  data  type  of  the  required  parameter  specifying 
the  handle  to  the  window  to  record.  This  parameter  can  either  be  a  hex  string  identifier  to  the 
handle  (e.g,  “0012079E”)  or  an  HWND. 

If  only  the  required  handle  identifier  parameter  is  supplied,  a  ScreenRecorder  directory  is 
created,  if  it  does  not  already  exist,  in  the  same  directory  as  the  executable.  The  images  of  the 
specified  window  are  then  saved  as  N_ScreenRecorder.png  in  this  directory  where  N  is  the 
image  number  starting  from  0  (Fig.  11,  lines  112  and  113). 
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//  ****  ScreenRecorder: : RecordByHandle  *++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

//  Handle  object  to  window  titled  "Microsoft  PowerPoint  -  [Sample. pptx] " 

HWND  handleObject  =  FindWindow(NULLj  "Microsoft  PowerPoint  -  [Sample. pptx] ") j 

//  Hex  value  of  handleObject  saved  as  a  string 
std::string  handlestring  =  toString(handleObject) j 

//  RecordByHandle(windowHandle) 

if  ( ! recorderl. RecordByHandle(handleObject)  || 

! recorderl. RecordByHandle(handleString) )  { 
std::cerr  <<  "ScreenRecorder :: RecordByHandle  failed"  <<  '\n'j 
}  //  if  (! recorderl. RecordByHandle( ...) ) 

//  RecordByHandle(windowHandlej  saveAsFile) 

if  ( ! recorder2. RecordByHandle(handleObject J  "RecordByHandle.tif")  || 

! recorder2. RecordByHandle (handiest ring,  "RecordByHandle.bmp" ) )  { 
std::cerr  <<  "ScreenRecorder :: RecordByHandle  failed"  <<  '\n'; 

}  //  if  ( ! recorder2. RecordByHandle( . . . ) ) 

//  RecordByHandle(windowHandlej  saveAsFile,  saveAsPath) 

if  ( ! recorders. RecordByHandle(handleObjectj  "RecordByHandle.gif", 

"C : \\Documents\\ScreenRecorder" )  | | 

! recorders. RecordByHandle (handiest ring,  "RecordByHandle. jpeg" , 

"C : \\Documents\\ScreenRecorder" ) )  { 
std::cerr  <<  "ScreenRecorder :: RecordByHandle  failed"  <<  '\n'j 
}  //  if  (! recorders. RecordByHandle( ...) ) 


Fig.  1 1  Sample  usage  of  RecordByHandle  functions  from  ScreenRecorderExamples_Record.cc.  See  Appendix  B 
for  full  documentation  of  ScreenRecorderExamples_Record.cc. 


If  a  single  string  parameter  is  supplied  in  addition  to  the  required  handle  identifier  parameter,  this 
parameter  speeifies  the  base  of  the  save-as  filename.  A  direetory  with  the  same  name  as  the 
filename  base  with  the  extension  removed  is  then  created,  if  it  does  not  already  exist,  in  the  same 
directory  as  the  executable.  The  images  of  the  specified  window  are  saved  as  N_filenameBase  in 
this  directory.  Again,  N  is  the  image  number  starting  from  0  and  filenameBase  is  the  user- 
specified  filename  base  (Fig.  11,  lines  118  and  119). 
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If  2  string  parameters  are  supplied  in  addition  to  the  required  handle  identifier  parameter,  the  first 
parameter  specifies  the  base  of  the  save-as  filename  and  the  second  is  the  path  to  the  desired  save 
location.  A  directory  with  the  same  name  as  the  filename  base  with  the  extension  removed  is 
then  created,  if  it  does  not  already  exist,  in  the  specified  directory.  The  images  of  the  specified 
window  are  saved  as  N_filenameBase  in  this  directory.  Again,  N  is  the  image  number  starting 
from  0  and  filenameBase  is  the  user-specified  filename  base  (Fig.  11,  lines  124-127). 

The  return  value  of  RecordByHandle  indicates  whether  or  not  the  specified  window  was  found 
and  the  desired  series  of  images  of  this  window  were  successfully  saved.  If  the  user  specifies  the 
filename  base,  the  RecordByHandle  function  will  return  false  if  the  filename  base  does  not  end 
with  one  of  the  supported  file  format  extensions.  If  the  user  specifies  a  save  path  that  does  not 
exist,  RecordByHandle  will  return  false. 


5.  Conclusion 


The  ScreenRecorder  utility  was  developed  for  saving  series  of  desktop  or  window  screenshots 
directly  to  file  on  any  system  running  Microsoft  Windows  as  an  alternative  to  restrictive  third- 
party  screen  recording  software  options.  With  the  use  of  Microsoft  Visual  Studio,  the 
ScreenRecorder  utility  was  developed  as  a  C-i-i-  class  that  can  be  compiled  as  a  library  (static  or 
dynamic)  to  be  linked  into  a  project  or  can  easily  be  compiled  into  an  executable  with  the  use  of 
wrapper  code.  One  major  advantage  of  structuring  the  ScreenRecorder  utility  this  way  and 
distributing  the  source  code  (as  opposed  to  only  distributing  an  executable)  is  that  the 
ScreenRecorder  can  be  directly  embedded  into  and  manipulated  within  new  and  existing  models. 

The  ScreenRecorder  utility  has  been  tested  on  and  is  compatible  with  Microsoft  Vista,  7,  and  8 
and  Visual  Studio  Express  2008,  2010,  and  2012.  The  utility  supports  BMP,  GIF,  JPEG,  PNG, 
and  TIFF  image  formats.  Once  the  ScreenRecorder  utility  has  saved  a  series  of  screenshots  in  the 
desired  format,  Windows  Movie  Maker  (or  other  appropriate  software)  can  be  used  to  combine 
the  screenshot  images  into  a  WMV  or  AVI  movie  file. 

Examples  of  wrapper  codes  and  linking  options  are  provided  to  the  user  in  Appendices  A  and  B. 
All  source  code  is  provided  to  the  user  in  Appendices  C  and  D. 
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types  [i.e.,  ScreenRecorder(double,  double)].  This  restricts  the  value  of  the  frame  rate  when 
setting  it  through  the  constructor.  If  a  noninteger  frame  rate  is  desired,  the  user  can  either 
calculate  the  corresponding  time  step  and  use  the  appropriate  constructor  or  set  the  frame 
rate  using  the  SetErameRate  mutator  discussed  in  Section  3.3. 

10.  When  error  checking  for  equality  in  parameter  values,  the  ScreenRecorder  utility  uses  a 
tolerance  of  l.Oe-10. 
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Appendix  A.  ScreenRecorderExamples_Capture.cc 


This  appendix  appears  in  its  original  form,  without  editorial  change. 
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Examples  of  using  screen  capture  functions. 


1 

2 

3 

4 

5 

6 
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8 
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23 
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27 

28 

29 
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31 

32 

33 

34 

35 

36 

37 
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40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 


//  12/01/2014  MKA  **+**+**++* 

//  ScreenRecorderExamples_Capture. cc :  Examples  of  screen  caputure  functions  *****+***** 


#include  <cstdio> 

#include  <iostream> 
#include  <sstream> 

#include  "ScreenRecorder.h 


//  Link  user32j  gdi32j  and  gdiplus  libraries 
#pragma  comment(libj  "user32") 

#pragma  comment(libj  "gdi32") 

#pragma  comment(libj  "gdiplus") 

template  <  typename  T  > 

std::string  toString(T  x)  {  //  Converts  x  to  a  std::string 

std : : stringstream  sstr; 
sstr  <<  xj 
return  sstr.str(); 

}  //  std:: string  toString 

int  main(int  argCj  char*  argv[])  { 

ScreenRecorder  recorder;  //  ScreenRecorder  object 

//  ****  ScreenRecorder :: CaptureDesktop  *++**+**+**++*++*++**+**+**++*+**++**+**+**++* 
//  CaptureDesktop 

if  ( IScreenRecorder: :CaptureDesktop()  ||  //  Invoked  without  use  of  a  class  object 

! recorder .CaptureDesktop( ) )  {  //  Invoked  through  a  class  object 

std::cerr  <<  "ScreenRecorder: :CaptureDesktop  failed"  <<  std::endl; 

}  //  if  ( ! CaptureDesktop( ) ) 

//  CaptureDesktop(saveAsFile) 

if  ( IScreenRecorder: :CaptureDesktop("CaptureDesktop. bmp")  || 

! recorder .CaptureDesktop( "CaptureDesktop.bmp"))  { 
std::cerr  <<  "ScreenRecorder: :CaptureDesktop  failed"  <<  std::endl; 

}  //  if  ( ! CaptureDesktop( . . . ) ) 

//  CaptureDesktop(saveAsFilej  saveAsPath) 

if  ( IScreenRecorder: :CaptureDesktop("CaptureDesktop.gif"j 

"C:\\Documents\\ScreenRecorder")  | | 

! recorder .CaptureDesktop( "CaptureDesktop. gif "j 

"C : \\Documents\\ScreenRecorder" ) )  { 
std::cerr  <<  "ScreenRecorder: :CaptureDesktop  failed"  <<  std::endl; 

}  //  if  ( ! CaptureDesktop( . . . ) ) 

//  ****  ScreenRecorder : :CaptureByTitle  *++**+*++**++*++*++**+**+**++*+**++**+**+**++* 
//  CaptureByTitle(windowTitle) 

if  ( IScreenRecorder: :CaptureByTitle("Microsoft  PowerPoint  -  [Sample. pptx]")  || 

! recorder .CaptureByTitle( "Microsoft  PowerPoint  -  [Sample. pptx] ") )  { 
std::cerr  <<  "ScreenRecorder: :CaptureByTitle  failed"  <<  std::endl; 

}  //  if  ( ! CaptureByTitle( . . . ) ) 

//  CaptureByTitle(windowTitlej  saveAsFile) 

if  ( IScreenRecorder: :CaptureByTitle("Microsoft  PowerPoint  -  [Sample. pptx] "j 
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60 

"CaptureByTitle. jpeg")  | | 

61 

! recorder .CaptureByTitle( "Microsoft  PowerPoint  -  [Sample . pptx] "j 

62 

"CaptureByTitle.jpg"))  { 

63 

std::cerr  <<  "ScreenRecorder: :CaptureByTitle  failed"  <<  std::endl; 

64 

65 

66 

}  //  if  ( ! CaptureByTitle( . . . ) ) 

//  CaptureByTitle(windowTitlej  saveAsFilej  saveAsPath) 

67 

if  ( IScreenRecorder: :CaptureByTitle("Microsoft  PowerPoint  -  [Sample. pptx] "j 

68 

"CaptureByTitle. png" j 

69 

"C:\\Documents\\ScreenRecorder")  | | 

70 

! recorder .CaptureByTitle( "Microsoft  PowerPoint  -  [Sample. pptx] "j 

71 

"CaptureByTitle. png"j 

72 

"C : \\Documents\\ScreenRecorder" ) )  { 

73 

std::cerr  <<  "ScreenRecorder: :CaptureByTitle  failed"  <<  std::endlj 

74 

75 

}  //  if  ( ! CaptureByTitle( . . . ) ) 

76 

77 

78 

//  ****  ScreenRecorder : :CaptureByHandle  ****+*+***++*++*+***+*****+**+**++**+**+***+* 

//  Handle  object  to  window  titled  "Microsoft  PowerPoint  -  [Sample. pptx] " 

79 

80 

81 

HWND  handleObject  =  FindWindow(NULLj  "Microsoft  PowerPoint  -  [Sample. pptx] ") ; 

//  Hex  value  of  handleObject  saved  as  a  string 

82 

83 

84 

std::string  handlestring  =  toString(handleObject) j 

//  CaptureByHandle(windowHandle) 

85 

if  ( IScreenRecorder: :CaptureByHandle(handleObject)  || 

86 

! recorder .CaptureByHandle(handleObject)  | | 

87 

IScreenRecorder: :CaptureByHandle(handleString)  | | 

88 

! recorder. CaptureByHandle(handleString))  { 

89 

std::cerr  <<  "ScreenRecorder: :CaptureByHandle  failed"  <<  std::endlj 

90 

91 

}  //  if  ( ! CaptureByHandle( . . . ) ) 

92 

//  CaptureByHandle(windowHandlej  saveAsFile) 

93 

if  ( IScreenRecorder: :CaptureByHandle(handleObjectj  "CaptureByHandle.tiff ")  || 

94 

! recorder .CaptureByHandle(handleObjectj  "CaptureByHandle.tif")  | | 

95 

IScreenRecorder: :CaptureByHandle(handleStringj  "CaptureByHandle.bmp")  | | 

96 

! recorder .Capt ureByHandle( handiest ring J  "CaptureByHandle . gif ") )  { 

97 

std::cerr  <<  "ScreenRecorder: :CaptureByHandle  failed"  <<  std::endl; 

98 

99 

100 

}  //  if  ( ! CaptureByHandle( . . . ) ) 

//  CaptureByHandle(windowHandlej  saveAsFilej  saveAsPath) 

101 

if  (IScreenRecorder: : CaptureByHandle(handleObjectj  "CaptureByHandle. jpg"j 

102 

"C : \\Documents\\ScreenRecorder" )  | | 

103 

! recorder . CaptureByHandle (handleObject J  "CaptureByHandle. png" j 

104 

"C : \\Documents\\ScreenRecorder" )  | | 

105 

! ScreenRecorder: : CaptureByHandle(handleStringj  "CaptureByHandle. t if "j 

106 

"C : \\Documents\\ScreenRecorder" )  | | 

107 

! recorder .CaptureByHandle(handleStringj  "CaptureByHandle. bmp"j 

108 

"C : \\Documents\\ScreenRecorder" ) )  { 

109 

std::cerr  <<  "ScreenRecorder: :CaptureByHandle  failed"  <<  std::endlj 

110 

}  //  if  ( ! CaptureByHandle( . . . ) ) 

111 

112 

system("pause")j 

113 

114 

return  0j 

115 

}  //  int  main 
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Intentionally  left  blank. 
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Appendix  B.  ScreenRecorderExamples_Record.cc 


This  appendix  appears  in  its  original  form,  without  editorial  change. 
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Examples  of  using  screen  recording  functions. 


1 

II  *++*++*++**+**+**++*+**++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

2 

II  ********************************************************************************* 

3 

II  12/01/2014  MKA  **5(c*****5(c5(c* 

4 

//  ScreenRecorderExamples_Record. cc :  Examples  of  screen  recording  functions  *********+* 

5 

II  *++*++*++**+**+**++*+**++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

6 

7 

8 

#include  <cstdio> 

9 

#include  <iostream> 

10 

#include  <sstream> 

11 

12 

13 

#include  "ScreenRecorder.h" 

//  Link  user32j  gdi32j  and  gdiplus  libraries 

14 

#pragma  comment(libj  "user32") 

15 

#pragma  comment(libj  "gdi32") 

16 

17 

18 

#pragma  comment(libj  "gdiplus") 

template  <  typename  T  > 

19 

std::string  toString(T  x)  {  //  Converts  x  to  a  std::string 

20 

std : : stringstream  sstr; 

21 

sstr  <<  xj 

22 

return  sstr.str(); 

23 

}  //  std:: string  toString 

24 

25 

26 

27 

28 

29 

int  main(int  argCj  char*  argv[])  { 

//  ****  ScreenRecorder  Object  Constructors  *+*++**++*++*++**+**+**++*+**++**+**+**++* 

ScreenRecorder  recorderl;  //  Default  constructor 

30 

ScreenRecorder  recorder2(60. 0j  10)j  //  Specifying  frame  rate  and  recording  time 

31 

32 

33 

ScreenRecorder  recorder3(60. 0j  1.0)j  //  Specifying  time  step  and  recording  time 

//  ****  ScreenRecorder  Getters  and  Setters  *+*++**++*++*++**+**+**++*+**++**+**+**++* 

34 

35 

std::cout  <<  "Default  record  time  (s)  =  "  <<  recorderl.GetRecordTime()  <<  '\n'j 

36 

std::cout  <<  "Default  frame  rate  (fps)  =  "  <<  recorderl.GetFrameRate()  <<  '\n'j 

37 

std::cout  <<  "Default  time  step  (s)  =  "  <<  recorderl.GetTimeStepO  <<  '\n'j 

38 

std::cout  <<  std::endl; 

39 

//  Output: 

40 

//  Default  record  time  (s)  =  60.0 

41 

//  Default  frame  rate  (fps)  =  1.0 

42 

//  Default  time  step  (s)  =  1.0 

43 

44 

recorderl.SetFrameRate(2) j  //  Also  changes  time  step! 

45 

std::cout  <<  "Default  record  time  (s)  =  "  <<  recorderl.GetRecordTime()  <<  '\n'; 

46 

std::cout  <<  "New  frame  rate  (fps)  =  "  <<  recorderl.GetFrameRate()  <<  '\n'; 

47 

std::cout  <<  "New  time  step  (s)  =  "  <<  recorderl.GetTimeStepO  <<  '\n'; 

48 

std::cout  <<  std::endl; 

49 

//  Output: 

50 

//  Default  record  time  (s)  =  60.0 

51 

//  New  frame  rate  (fps)  =  2.0 

52 

53 

54 

//  New  time  step  (s)  =  0.5 

recorderl.SetRecordTime(120.0) j 

55 

recorderl.SetTimeStep(2.0) j  //  Also  changes  frame  rate! 

56 

std::cout  <<  "New  record  time  (s)  =  "  <<  recorderl.GetRecordTime()  <<  '\n'j 

57 

std::cout  <<  "New  frame  rate  (fps)  =  "  <<  recorderl.GetFrameRate()  <<  '\n'j 

58 

std::cout  <<  "New  time  step  (s)  =  "  <<  recorderl.GetTimeStepO  <<  '\n'j 

59 

std::cout  <<  std::endlj 
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60 

//  Output: 

61 

//  New  record  time  (s)  =  120.0 

62 

//  New  frame  rate  (fps)  =0.5 

63 

64 

65 

66 

67 

//  New  time  step  (s)  =  2.0 

//  ****  ScreenRecorder : : RecordDesktop  +*++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

//  RecordDesktop 

68 

if  ( ! recorderl. RecordDesktop( ) )  { 

69 

std::cerr  <<  "ScreenRecorder :: RecordDesktop  failed"  <<  '\n'j 

70 

71 

72 

}  //  if  (! recorderl. RecordDesktopO ) 

//  RecordDesktop(f ileNameBase) 

73 

if  (! recorder2. RecordDesktop( "RecordDesktop. bmp" ) )  { 

74 

std::cerr  <<  "ScreenRecorder :: RecordDesktop  failed"  <<  '\n'j 

75 

76 

77 

}  //  if  ( ! recorder2. RecordDesktop( . . . ) ) 

//  RecordDesktop(f ileNameBasej  saveAsPath) 

78 

if  ( ! recorders. RecordDesktop( "RecordDesktop. gif "j 

79 

"C : \\Documents\\ScreenRecorder" ) )  { 

80 

std::cerr  <<  "ScreenRecorder :: RecordDesktop  failed"  <<  '\n'; 

81 

82 

83 

84 

85 

}  //  if  (! recorders. RecordDesktop( ...) ) 

//  ****  ScreenRecorder: :RecordByTltle  +*++**+*++**++*++*++**+**+**++*+**++**+**+***** 

//  RecordByTitle(windowTitle) 

86 

if  (! recorderl. RecordByTitle( "Microsoft  PowerPoint  -  [Sample . pptx] ") )  { 

87 

std::cerr  <<  "ScreenRecorder :: RecordByTitle  failed"  <<  '\n'j 

88 

89 

90 

}  //  if  (! recorderl. RecordByTitle( ...) ) 

//  RecordByTitle(windowTitlej  f ileNameBase) 

91 

if  (! recorder2. RecordByTitle( "Microsoft  PowerPoint  -  [Sample. pptx] "j 

92 

"RecordByTitle. jpeg"))  { 

93 

std::cerr  <<  "ScreenRecorder :: RecordByTitle  failed"  <<  '\n'j 

94 

95 

96 

}  //  if  ( ! recorder2. RecordByTitle( . . . ) ) 

//  RecordByTitle(windowTitlej  f ileNameBasej  saveAsPath) 

97 

if  (! recorders. RecordByTitle( "Microsoft  PowerPoint  -  [Sample. pptx] "j 

98 

"RecordByTitle. png" j 

99 

"C : \\Documents\\ScreenRecorder" ) )  { 

100 

std::cerr  <<  "ScreenRecorder :: RecordByTitle  failed"  <<  '\n'; 

101 

}  //  if  (! recorders. RecordByTitle( ...) ) 

102 

103 

//  ****  ScreenRecorder: :RecordByHandle  *++**+*++**+**+**++**+**+**++*+**++**+**+**++* 

104 

105 

//  Handle  object  to  window  titled  "Microsoft  PowerPoint  -  [Sample. pptx] " 

106 

HWND  handleObject  =  FindWindow(NULLj  "Microsoft  PowerPoint  -  [Sample. pptx] ") ; 

107 

108 

//  Hex  value  of  handleObject  saved  as  a  string 

109 

std::string  handlestring  =  toString(handleObject) j 

110 

111 

//  RecordByHandle(windowHandle) 

112 

if  (! recorderl. RecordByHandle(handleObject)  || 

113 

! recorderl. RecordByHandle(handleString) )  { 

114 

std::cerr  <<  "ScreenRecorder :: RecordByHandle  failed"  <<  '\n'j 

115 

}  //  if  (! recorderl. RecordByHandle( ...) ) 

116 

117 

//  RecordByHandle(windowHandlej  fileNameBase) 

118 

if  ( ! recorder2. RecordByHandle(handleObjectj  "RecordByHandle.tif")  || 

119 

! recorder2. RecordByHandle(handleStringj  "RecordByHandle.bmp" ) )  { 

120 

std::cerr  <<  "ScreenRecorder :: RecordByHandle  failed"  <<  '\n'; 
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121 

}  //  if  ( ! recorder2. RecordByHandle( . . . ) ) 

122 

123 

//  RecordByHandle(windowHandlej  fileNameBasej  saveAsPath) 

124 

if  ( ! recorder3. RecordByHandle(handleObject j  "RecordByHandle. gif " j 

125 

"C : \\Documents\\ScreenRecorder" )  | | 

126 

! recorder3. RecordByHandle(handleStringj  "RecordByHandle. jpeg" j 

127 

"C : \\Documents\\ScreenRecorder" ) )  { 

128 

std::cerr  <<  "ScreenRecorder: : RecordByHandle  failed"  <<  '\n'j 

129 

}  //  if  ( ! recorder3. RecordByHandle( . . . ) ) 

130 

131 

system("pause")j 

132 

133 

return  0j 

134 

}  //  int  main 
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Appendix  C.  ScreenRecorder.h 


This  appendix  appears  in  its  original  form,  without  editorial  change. 
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Interface  for  the  ScreenRecorder  class. 


1 

II  *++*++*++**+**+**++*+**++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

2 

II  ^,4f********************************************************************************** 

3 

//  12/01/2014  MKA  ************************** 

4 

II  ScreenRecorder . h :  Interface  for  the  ScreenRecorder  class.  ************************** 

5 

II  ************************************************************************************ 

6 

7 

8 

#ifndef  SCREEN  RECORDER  H 

9 

#define  SCREEN  RECORDER  H 

10 

#include  <sstream> 

11 

#include  <string> 

12 

#include  <windows.h> 

13 

14 

#define  TOL  1.0e-10 

15 

#define  DEFAULT  MAXT  60.0 

16 

#deflne  DEFAULT  DT  1.0 

17 

#deflne  DEFAULT  FPS  1 

18 

19 

class  ScreenRecorder  { 

20 

public : 

21 

//  ****  Static  Methods  -  Screen  Capture  ********************************************* 

22 

23 

static  bool  CaptureDesktop(std :: string  saveAsFile  =  "ScreenCapture. png"j 

24 

std::string  saveAsPath  = 

25 

static  bool  CaptureByTitle(std: :string  titlej 

26 

std::string  saveAsFile  =  "ScreenCapture . png" j 

27 

std::string  saveAsPath  =  "")j 

28 

static  bool  CaptureByHandle(std :: string  handlej 

29 

std::string  saveAsFile  =  "ScreenCapture . png" j 

30 

std::string  saveAsPath  =  "")j 

31 

static  bool  CaptureByHandle(HWND  hWndj 

32 

std::string  saveAsFile  =  "ScreenCapture . png" j 

33 

std::string  saveAsPath  =  "")j 

34 

35 

//  ****  Constructors  **************************************************************** 

36 

37 

ScreenRecorder( ) \ 

38 

ScreenRecorder(double  recordTimej  int  frameRate); 

39 

ScreenRecorder(double  recordTimej  double  timeStep); 

40 

41 

//  ****  Accessors  ******************************************************************* 

42 

43 

double  GetRecordTime( ); 

44 

double  GetFrameRate( ) j 

45 

double  GetTimeStepO j 

46 

47 

//  ****  Mutators  ******************************************************************** 

48 

49 

void  SetRecordTime(double  recordTime)j 

50 

void  SetFrameRate(double  frameRate); 

51 

void  SetTimeStep(double  dT); 

52 

53 

//  ****  Non-Static  Methods  -  Screen  Record  ****************************************** 

54 

55 

bool  RecordDesktop(std :: string  fileNameBase  =  "ScreenRecorder. png" j 

56 

std::string  saveAsPath  = 

57 

bool  RecordByTitle(std :: string  titlej 

58 

std::string  fileNameBase  =  "ScreenRecorder. png" j 

59 

std::string  saveAsPath  = 

24 


60 

bool  RecondByHandle(std :: string  handlOj 

61 

std::string  fileNameBase  =  "ScreenRecorder. png" j 

62 

std::string  saveAsPath  = 

63 

bool  RecondByHandle(HWND  hWndj 

64 

std::string  fileNameBase  =  "ScreenRecorder. png" j 

65 

std::string  saveAsPath  =  "")j 

66 

67 

private : 

68 

/ /  ClSSS  \/3PX3Id16S 

69 

70 

double  fpsj  //  framerate  (frames  per  second) 

71 

double  dTj  //  timestep  (sec) 

72 

double  maxTj  //  total  time  to  record  (sec) 

73 

74 

//  ****  Private  Methods  ++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+*****++* 

75 

76 

static  std::string  GetExeFileName( ) ; 

77 

static  std:: string  GetExePath( ) ; 

78 

static  wchar  t*  GetWC(const  char  *c); 

79 

static  int  GetEncoderClsid(const  WCHAR*  formatj  CLSID*  pClsid); 

80 

81 

template  <  typename  T  > 

82 

static  std:: string  toLower(T  str)  {  //  Changes  str  to  all  lower  case  std:: string 

83 

unsigned  int  i; 

84 

std::string  newStr  =  static_cast<std: :string>(str); 

85 

for  (i  =  0;  i  <  newStr.length();  ++i)  { 

86 

newStr[i]  =  tolower(str[i])j 

87 

}  //  for  (i  =  0j  i  <  newStr.lengthO;  ++i) 

88 

return  newStrj 

89 

}  //  std:: string  toLower 

90 

91 

template  <  typename  T  > 

92 

std::string  toString(T  x)  {  //  Converts  x  to  a  std::string 

93 

std : : stringstream  sstrj 

94 

sstr  <<  xj 

95 

return  sstr.str()j 

96 

}  //  std:: string  toString 

97 

};  //  class  ScreenRecorder 

98 

#endlf  //  #ifndef  _SCREEN_RECORDER_H_ 
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Intentionally  left  blank. 
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Appendix  D.  ScreenRecorder.ee 


This  appendix  appears  in  its  original  form,  without  editorial  change. 
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Implementation  of  the  ScreenRecorder  class. 


1 

II  *++*++*++**+**+**++*+**++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

2 

II  *++*++*++**+**+**++*+**++**+**+**++*++*++**+*++**++*++*++**+**+**+**+**+***+**+**++* 

3 

//  12/01/2014  MKA  ********************* 

4 

II  ScreenRecorder . cc :  Implementation  of  the  ScreenRecorder  class.  ********+************ 

5 

II  *++*++*++**+**+**++*+**++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

6 

7 

8 

#define  CRT  SECURE  NO  DEPRECATE 

9 

#include  <ctime> 

10 

#include  <direct.h> 

11 

#include  <errno.h> 

12 

#include  <windows.h>  //  Has  to  be  before  <gdiplus.h> 

13 

#include  <gdiplus.h> 

14 

#include  <iostream> 

15 

#include  <string> 

16 

17 

18 

#include  "ScreenRecorder. h" 

II  ************************************************************************************ 

19 

II  *++*  static  Methods  -  Screen  Capture  +*++**+*++**++*++*++**+**+**++*+**++**+******** 

20 

n  ************************************************************************************ 

21 

22 

bool  ScreenRecorder : :CaptureDesktop(std :: string  saveAsFilej 

23 

std:: string  saveAsPath)  { 

24 

return  CaptureByHandle(NULLj  saveAsFilej  saveAsPath); 

25 

}  //  bool  ScreenRecorder :: CaptureDesktop 

26 

27 

bool  ScreenRecorder : :CaptureByTitle(std :: string  titlej 

28 

std:: string  saveAsFilej 

29 

std:: string  saveAsPath)  { 

30 

HWND  hWnd  =  FindWindow(NULLj  TEXT(title.c_str()))j 

31 

if  ( ! hWnd)  { 

32 

return  false; 

33 

}  //  if  (!hWnd) 

34 

return  CaptureByHandle(hWndj  saveAsFilej  saveAsPath); 

35 

}  //  bool  ScreenRecorder : :CaptureByTitle 

36 

37 

bool  ScreenRecorder: :CaptureByHandle(std: :string  handlej 

38 

std:: string  saveAsFilej 

39 

std::string  saveAsPath)  { 

40 

HWND  hWnd  =  (HWND)  wcstoul(GetWC(handle . c_str( ) ) j  NULLj  16); 

41 

if  ( ! hWnd)  { 

42 

return  false; 

43 

}  //  if  (!hWnd) 

44 

return  CaptureByHandle(hWndj  saveAsFilej  saveAsPath); 

45 

}  //  bool  ScreenRecorder :: CaptureByHandle 

46 

47 

bool  ScreenRecorder: :CaptureByHandle(HWND  hWndj 

48 

std:: string  saveAsFilej 

49 

std::string  saveAsPath)  { 

50 

Gdiplus: :GdiplusStartupInput  gdiplusStartupInput; 

51 

ULONG  PTR  gdiplusToken; 

52 

53 

54 

Gdiplus: :GdiplusStartup(&gdiplusTokenj  SgdiplusStartupInputj  NULL); 

RECT  rect  =  {0}; 

55 

int  width  =  GetSystemMetrics(SM_CXSCREEN) ; 

56 

int  height  =  GetSystemMetrics(SM_CYSCREEN) ; 

57 

if  (saveAsPath. length( )  ==  0){ 

58 

saveAsPath  =  GetExePath( ); 

59 

}  //  if  (saveAsPath. lenghtO  ==  0) 
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60 

if  (saveAsPath[saveAsPath. lengthO -1]  !=  '\\')  { 

61 

saveAsPath  +=  'W; 

62 

}  //  if  (saveAsPath[saveAsPath. lengthO -1]  !=  '\\') 

63 

wchar_t*  fileName  =  GetWC((saveAsPath+saveAsFile) .c_str()); 

64 

std::string  extension  =  saveAsFile.substr(saveAsFile.find  last  of ( ' . ' )  +  Ij 

65 

66 

saveAsFile . length( ) ) j 

67 

extension  =  toLower(extension) j 

68 

if  (extension  ==  "jpg")  { 

69 

extension  =  "jpeg"j 

70 

}  else  if  (extension  ==  "tif")  { 

71 

extension  =  "tiff'j 

72 

}  //  adjust  extension  to  account  for  common  alternate  format  abbreviations 

73 

74 

75 

wchar_t*  format  =  GetWC(( "image/"  +  extension) .c_str())j 

HWND  desktop  =  GetDesktopWindow( ) ; 

76 

HDC  desktopHdc  =  GetDC(desktop) j 

77 

HDC  destHdc  =  CreateCompatibleDC(desktopHdc); 

78 

79 

80 

HDC  iconHdc  =  CreateCompatibleDC(desktopHdc); 

if  (hWnd)  { 

81 

//  If  window  handle  was  specif iedj  then: 

82 

//  1)  bring  window  to  front 

83 

//  2)  fix  the  window  to  stay  on  stop  and  not  change  size  or  position 

84 

//  3)  update  capture  region  size 

85 

//  Otherwisej  capture  the  entire  desktop 

86 

if  (IsIconic(hWnd) )  { 

87 

ShowWindow(hWndj  SW_SHOWNORMAL ) j 

88 

}  //  if  (IsIconic(hWnd)) 

89 

SetWindowPos(hWndj  HWND_TOPMOSTj  0j  0j  0j  0j 

90 

SWP_NOMOVE  1  SWP_NOSIZE  |  SWP_SHOWWINDOW) j 

91 

GetWindowRect(hWndj  &rect)j 

92 

//  Double  check  that  the  window  is  validj  if  notj  then  capture  entire  desktop 

93 

if  (rect. right  >=  rect.left)  { 

94 

width  =  rect. right  -  rect. left j 

95 

}  //  if  (rect. right  >=  rect.left) 

96 

if  (rect. bottom  >=  rect. top)  { 

97 

height  =  rect. bottom  -  rect. top; 

98 

}  //  if  (rect. bottom  >=  rect. top) 

99 

}  //  if  (hWnd) 

100 

101 

//  Copy  image  to  HBITMAP  object 

102 

HBITMAP  destBmp  =  CreateCompatibleBitmap(desktopHdCj  widthj  height); 

103 

HBITMAP  oldBmp  =  (HBITMAP)SelectObject(destHdCj  destBmp); 

104 

BitBlt(destHdCj  0j  0j  widthj  heightj 

105 

desktopHdCj  rect.leftj  rect.topj  SRCCOPY  |  CAPTUREBLT); 

106 

SelectObject(destHdc J  oldBmp); 

107 

108 

//  Prepare  to  save  in  specified  format  (bmpj  jpegj  gifj  tiffj  or  png) 

109 

Gdiplus :: Bitmap*  newBmp  =  Gdiplus :: Bitmap: : FromHBITMAP(destBmpj  NULL); 

110 

Gdiplus : :Status  status  =  Gdiplus: :GenericError; 

111 

CLSID  clsid; 

112 

if  (newBmp  &&  (GetEncoderClsid(format j  Sclsid)  !=  -1))  { 

113 

//  Able  to  create  Bitmap  from  HBITMAP  and  found  valid  clsid 

114 

status  =  newBmp->Save(fileNamej  Sclsidj  NULL); 

115 

}  //  if  (newBmp  &&  (GetEncoderClsid(format j  &clsid)  !=  -1)) 

116 

117 

//  Cleanup 

118 

if  (hWnd)  { 

119 

SetWindowPos(hWndj  HWND_NOTOPMOSTj  rect.leftj  rect.topj  widthj  heightj 

120 

SWP_SHOWWINDOW); 
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121 

}  //  if  (hWdn) 

122 

if  (newBmp)  { 

123 

delete  newBmp; 

124 

}  //  if  (newBmp) 

125 

Gdiplus : :GdiplusShutdown(gdiplusToken) j 

126 

ReleaseDC(desktopj  desktopHdc); 

127 

DeleteObject(destBmp) j 

128 

DeleteDC (destHdc ) j 

129 

130 

return  (status  ==  Gdiplus : :0k) j 

131 

}  //  bool  ScreenRecorder : : CaptureByHandle 

132 

133 

II  *++*++*++**+**+**++*+**++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

134 

//  ****  Constructors  +*+**++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

135 

II  ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 

136 

137 

ScreenRecorder: :ScreenRecorder( )  { 

138 

SetRecordTime(DEFAULT_MAXT); 

139 

SetTimeStep(DEFAULT_DT); 

140 

}  //  ScreenRecorder: :ScreenRecorder 

141 

142 

ScreenRecorder : :ScreenRecorder(double  recordTimej  int  frameRate)  { 

143 

SetRecordTime(recordTime) j 

144 

SetFrameRate( static  cast<double>(f rameRate) ) j 

145 

}  //  ScreenRecorder: :ScreenRecorder 

146 

147 

ScreenRecorder : :ScreenRecorder(double  recordTimej  double  timeStep)  { 

148 

SetRecordTime(recordTime) J 

149 

SetTimeStep(timeStep) J 

150 

}  //  ScreenRecorder: :ScreenRecorder 

151 

152 

II  *++*++*++**+**+**++*+**++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

153 

//  ****  Accessors  **++*+**++**+**+**++*++*++**+*++**++*++*++**+**+**+**+**++**+**+**++* 

154 

II  ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 

155 

156 

double  ScreenRecorder: :GetRecordTime()  { 

157 

return  maxTj 

158 

}  //  double  ScreenRecorder : :GetRecordTime 

159 

160 

double  ScreenRecorder: :GetFrameRate()  { 

161 

return  fps; 

162 

}  //  double  ScreenRecorder : :GetFrameRate 

163 

164 

double  ScreenRecorder: :GetTimeStep()  { 

165 

return  dT; 

166 

}  //  double  ScreenRecorder : :GetTimeStep 

167 

168 

II  ********************************************************************* 

169 

II  *++*  Mutators  +**++*+**++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

170 

II  ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 

171 

172 

void  ScreenRecorder: :SetRecordTime(double  recordTime)  { 

173 

if  (recordTime  <  TOL)  { 

174 

std::cerr  <<  "ScreenRecorder:  Record  time  must  be  >=  0.0"  <<  '\n'j 

175 

std::cerr  <<  "Continuing  with  default  record  time  (" 

176 

<<  DEFAULT  MAXT  <<  "  s)"  <<  std::endlj 

177 

recordTime  =  DEFAULT  MAXTj 

178 

}  //  if  (recordTime  <  0.0) 

179 

maxT  =  recordTime; 

180 

}  //  void  ScreenRecorder : :SetRecordTime 

181 
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182 

void  ScreenReconden: :SetFnameRate(double  frameRate)  { 

183 

if  (frameRate  <=  0.0)  { 

184 

std::cerr  <<  "ScreenRecorder :  Frame  rate  must  be  >  0"  <<  '\n'; 

185 

std::cerr  <<  "Continuing  with  default  frame  rate  (" 

186 

<<  DEFAULT  FPS  <<  ")"  <<  std::endlj 

187 

frameRate  =  DEFAULT  FPSj 

188 

}  //  if  (frameRate  <=  0.0) 

189 

fps  =  frameRatej 

190 

dT  =  1.0  /  fpsj 

191 

}  //  void  ScreenRecorder :: SetFrameRate 

192 

193 

void  ScreenRecorder: :SetTimeStep(double  timeStep)  { 

194 

if  (timeStep  <=  0.0)  { 

195 

std::cerr  <<  "ScreenRecorder:  Time  step  must  be  >  0.0"  <<  '\n'j 

196 

std::cerr  <<  "Continuing  with  default  time  step  (" 

197 

<<  DEFAULT  DT  <<  "  s)"  <<  std::endl; 

198 

timeStep  =  DEFAULT_DT; 

199 

}  //  if  (timeStep  <=  0.0) 

200 

dT  =  timeStep; 

201 

fps  =  1.0  /  dT; 

202 

}  //  void  ScreenRecorder : :SetTimeStep 

203 

204 

II  *  +  +  *  +  +  *  +  +  **  +  **  +  **  +  +  *  +  **  +  +  **  +  **  +  **  +  +  *  +  +  *****  +  *  +  +  **  +  +  *  +  +  *  +  +  **  +  **  +  **  +  **  +  **  +  =!;**  +  **  +  **  +  +  * 

205 

H  *++*  Non-Static  Members  -  Screen  Record  ***+*++**++*++*++**+**+**++*+**++**+**+**++* 

206 

II  *++*++*++**+**+**++*+**++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

207 

208 

bool  ScreenRecorder: :RecordDesktop(std: :string  fileNameBasej 

209 

std::string  saveAsPath)  { 

210 

return  RecordByFlandle(NULLj  fileNameBasej  saveAsPath); 

211 

}  //  bool  ScreenRecorder :: RecordDesktop 

212 

213 

bool  ScreenRecorder: :RecordByTitle(std: :string  titlej 

214 

std:: string  fileNameBasej 

215 

std::string  saveAsPath)  { 

216 

FIWND  hWnd  =  FindWindow(NULLj  TEXT(title.c  str())); 

217 

if  (!hWnd)  { 

218 

return  false; 

219 

}  //  if  (!hWnd) 

220 

return  RecordByHandle(hWndj  fileNameBasej  saveAsPath); 

221 

}  //  bool  ScreenRecorder :: RecordByTitle 

222 

223 

bool  ScreenRecorder: :RecordByHandle(std: :string  handlej 

224 

std:: string  fileNameBasej 

225 

std:: string  saveAsPath)  { 

226 

HWND  hWnd  =  (HWND)  wcstoul(GetWC(handle . c  str())j  NULLj  16); 

227 

if  (!hWnd)  { 

228 

return  false; 

229 

}  //  if  (!hWnd) 

230 

return  RecordByHandle(hWndj  fileNameBasej  saveAsPath); 

231 

}  //  bool  ScreenRecorder :: RecordByHandle 

232 

233 

bool  ScreenRecorder: :RecordByHandle(HWND  hWndj 

234 

std:: string  fileNameBasej 

235 

std:: string  saveAsPath)  { 

236 

clock  t  endTick; 

237 

clock  t  tl; 

238 

clock_t  t2; 

239 

errno  t  err; 

240 

int  tickStep  =  static  cast<int>(dT  *  CLOCKS  PER  SEC); 

241 

int  frame  =  0; 

242 

int  status; 
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243 

bool  wasSuccessful  =  true; 

244 

std:: string  saveAsFile; 

245 

246 

if  (saveAsPath. length( )  ==  0)  { 

247 

saveAsPath  =  GetExePath( ); 

248 

}  //  if  (saveAsPath. lengthO  ==  0) 

249 

if  (saveAsPath[saveAsPath. lengthO -1]  !=  ’W)  { 

250 

saveAsPath  +=  'W; 

251 

}  //  if  (saveAsPath[saveAsPath.length()-l]  !=  '\\') 

252 

saveAsPath  +=  f lleNameBase . substr(0j  fileNameBase.find  last  of('.'))j 

253 

saveAsFile  =  "  "  +  f lleNameBase; 

254 

255 

set  errno(0); 

256 

status  =  mkdir(saveAsPath.c  str()); 

257 

_get_errno(&err ) ; 

258 

wasSuccessful  =  ((status  ==  0)  | |  (err  ==  EEXIST)); 

259 

saveAsPath  +=  "\\"; 

260 

261 

tl  =  clock(); 

262 

endTick  =  tl  +  static  cast<int>(maxT  *  CLOCKS  PER  SEC); 

263 

t2  =  tl; 

264 

265 

while  (wasSuccessful  &&  (t2  <  endTick))  { 

266 

t2  =  clock(); 

267 

if  ((t2  -  tl)  >  tickStep)  { 

268 

wasSuccessful  =  ScreenRecorder : :CaptureByHandle(hWndj 

269 

toString(f name)  +  saveAsFilej  saveAsPath); 

270 

++f name; 

271 

tl  =  t2; 

272 

}  //  if  ((t2  -  tl)  >  tickStep) 

273 

}  //  while  (wasSuccessful  &&  (t2  <  endTick)) 

274 

275 

return  wasSuccessful; 

276 

}  //  bool  ScreenRecorder :: RecordByHandle 

277 

278 

II  *++*++*++**+**+**++*+**++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

279 

//  ****  Private  Methods  **++**+**+**++*++*++**+*++**++*++*++**+**+**++*+**++**+**+**++* 

280 

II  ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 

281 

282 

std::string  ScreenRecorder : :GetExeFileName()  { 

283 

char  buffer[MAX_PATH]; 

284 

GetModuleFileName(  NULLj  bufferj  MAX_PATH  ); 

285 

return  std : : string(buffer) ; 

286 

}  //  std::string  ScreenRecorder : :GetExeFileName 

287 

288 

std::string  ScreenRecorder : :GetExePath()  { 

289 

std:: string  f  =  GetExeFileName( ) ; 

290 

return  f.substr(0j  f .find_last_of (  "\\/"  )+l); 

291 

}  //  std::string  ScreenRecorder : :GetExePath 

292 

293 

wchar  t*  ScreenRecorder : :GetWC(const  char  *c)  { 

294 

const  size_t  cSize  =  strlen(c)+l; 

295 

wchar  t*  wc  =  new  wchar  t[cSize]; 

296 

mbstowcs(wCj  Cj  cSize); 

297 

298 

return  wc; 

299 

}  //  wchar  t*  ScreenRecorder : :GetWC 

300 

301 

II  http ://msdn . microsoft . com/en-us/library/windows/desktop/ms533843%28v=vs .85%29. aspx 

302 

Int  ScreenRecorder : :GetEncoderClsid(const  WCHAR*  formatj  CLSID*  pClsid)  { 

303 

//  bmpj  jpegj  gif,  tiff,  png 
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304 

DINT  num  =  0;  //  Number  of  image  encoders 

305 

DINT  size  =  0j  //  Size  of  the  image  encoder  array  in  bytes 

306 

307 

Gdiplus : : ImageCodecInfo*  pImageCodecInfo  =  NULL; 

308 

309 

Gdiplus: :GetImageEncodersSize(&numj  Ssize); 

310 

if  (size  ==  0)  { 

311 

return  -1;  //  Failure 

312 

}  //  if  (size  ==  0) 

313 

314 

pImageCodecInfo  =  (Gdiplus: :ImageCodecInfo*)(malloc(size)); 

315 

if  (pImageCodecInfo  ==  NULL)  { 

316 

return  -1;  //  Failure 

317 

}  //  if  (pImageCodecInfo  ==  NULL) 

318 

319 

GetImageEncoders(numj  sizej  pImageCodecInfo); 

320 

321 

for  (UINT  j  =  0;  j  <  num;  ++j)  { 

322 

if  (wcscmp(pImageCodecInfo[ j] .MimeTypej  format)  ==  0)  { 

323 

*pClsid  =  pImageCodecInfo[j] .Clsid; 

324 

free (pImageCodecInfo); 

325 

return  j;  //  Success 

326 

}  //  if  (wcscmp(pImageCodecInfo[j] .MimeTypej  format)  ==  0) 

327 

}  //  for  (UINT  j  =  0;  j  <  num;  ++j) 

328 

329 

free( pImageCodecInfo) ; 

330 

return  -1;  //  Failure 

331 

}  //  int  ScreenRecorder : :GetEncoderClsid 
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Appendix  E.  MATLAB  Script  for  Creating  AVI  Movie  from  Screenshots 


This  appendix  appears  in  its  original  form,  without  editorial  change. 
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1 

%%  Sample  script  for  creating  an  AVI  movie  from  individual  images 

3 

%  Path  to  where  images  are  saved 

4 

imagePath  =  'C:\Documents\ScreenRecorder\'; 

6 

%  File  base  name 

7 

8 

9 

imageName  =  ' RecordByHandle. tif ' j 

%  Name  of  created  video 

10 

movieName  =  'SampleMovie.avi'; 

11 

12 

%  Number  of  images  to  stitch  together 

13 

numFrames  =  50j 

14 

15 

%  Rate  of  playback  for  the  video  in  frames  per  second 

16 

frameRate  =  5; 

17 

18 

%  Create  video  writer  object  and  set  frame  rate 

19 

writerObj  =  VideoWriter(strcat(imagePathj  movieName)); 

20 

writerObj . FrameRate  =  frameRate; 

21 

22 

%  Open  video  writer  object  for  writing 

23 

open(writerObj ) ; 

24 

25 

%  Write  frames  to  video  writer  object 

26 

for  k  =  0  :  numFrames-1 

27 

fileName  =  strcat(imagePathj  sprintf ( ' %d%s ' j  kj  imageName)); 

28 

thisimage  =  imread(f ileName) ; 

29 

writeVideo(writerObj j  thisimage) ; 

30 

end 

31 

32 

%  Close  video  writer  object 

33 

close(writerObj ); 
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